            HBAnyware Web Launch Service Installation and Setup
            ---------------------------------------------------

Introduction
------------
The HBAnyware Web Launch feature allows a user to download and launch
the HBAnyware user interface by specifying the URL of a server that 
is hosting the HBAnyware Web Launch software.  The client machine from 
which the request is being made need not have the HBAnyware package or 
even an Emulex HBA installed.  All that is required is a standard web 
browser, or some other application capable of making HTTP requests.  
Even the Java runtime need not be resident, as that too will be auto-
matically downloaded if not already present.  

HBAnyware Web Launch relies on two key technologies -- Java Web Start 
and Java Remote Method Invocation (RMI).  Java Web Start is used to 
first download the appropriate HBAnyware resource file (HBAnyware Java
class archive) to the requesting client.  The downloaded application is 
then run on the requesting client, and thereafter uses RMI to communicate 
with the server hosting the HBAnyware software.

It is important to note that with this distributed approach, it is only 
the HBAnyware user interface feature (GUI) that is being exported to the 
requesting client -- not the entire HBAnyware software stack.  All HBA 
discovery and remote management operations will be carried out by resources 
running on the remote host that served up the GUI component.  Thus, the
SAN "view" displayed by the GUI is not from the perspective of the client
running the GUI, but rather from the perspective of the host from which 
this GUI was retrieved.

HBAnyware Web Launch Services requires that a Web Server be installed and 
running on the server that is hosting the Web Launch Services software.  
Currently, the only Web Server that is supported is the following:

   - Apache Web Server,  Version 1.3, or later


Web Server Setup
----------------

Your Apache Web server must be configured to recognize the JNLP (Java 
Network Load Protocol) MIME type.  This is accomplished as follows:

   - Change your working directory to the directory containing the 
     Apache configuration files (usually /etc/apache or /etc/apache2)
   - Edit the file 'mime.types'.
   - Add the following line to the file:

       application/x-java-jnlp-file jnlp JNLP

   - Save the file
   - Stop and restart the Web Server so that it can pick up this change.
     The method by which this is accomplished is usually platform specific.
     On the Solaris platform, the Apache Server is typically stopped/started
     via the following commands:

     /usr/apache/bin/apachectl stop
     /usr/apache/bin/apachectl start

Web Browser Setup
-----------------

Before you can launch HBAnyware from a browser, you must install the Java  
Web Start application on your browser host, and ensure that the browser is
properly configured for Java Web Start operation.  To do this, you will
need to install the appropriate version Java Runtime Environment (JRE)
on your browser.  Following are the JRE minimum version requirements:

   Platform          Minimum JRE version
   --------          -------------------
    x86              JRE Version 5.0 or later
    ia64             JRE Version 5.0 or later.  This must be the 32-bit
                     version, as Sun does not yet provide Java Web Start
                     support in the 64-bit JRE 5.x versions. This applies
                     to SLES-10 and SLES-10 SP1 platforms only.  Please
                     see the note below regarding Java Web Start support
                     on RHEL-4 and RHEL-5 platforms.
    x86-64           JRE Version 5.0 or later.  This must be the 32-bit
                     version, as Sun does not yet provide Java Web Start
                     support in the 64-bit JRE 5.x version.
    ppc64            JRE Version 5.0
    Solaris Sparc    JRE Version 5.0 or later.  This must be the 32-bit
                     version, as Sun does not yet provide Java Web Start
                     support in the 64-bit JRE 5.x version.
                    
The Java Web Start application is automatically included with these
versions of the JRE.

Due to waning Java support by Sun for the ia64 platform, ia64 platforms
running RHEL-4 and RHEL-5 cannot be used as HBAnyware Web Launch browser
clients.

Java Runtime Environment (JRE) downloads, plus accompanying documentation 
are available at the following Sun download sites:

   http://java.sun.com/downloads
   http://java.sun.com/products/javawebstart/download.jsp

Java Web Start setup is different from browser to browser, and from platform
to platform.  For some browsers and platforms, the JRE installer automatically
performs all of the necessary Web Start and browser setup.  Still, this is
not the case for many other browsers, and for these you will need to perform 
the setup yourself. This setup consists of configuring your browser such that 
it recognizes the JNLP mime file type.  For most browsers, this entails 
performing the following:

   - Bring up your web browser.
   - Go to the web browsers' preferences/setup menu.
   - Go to the setup menus' "file associations" section, and create 
     an association between JNLP files (i.e. files with a '.jnlp'
     extension), and the mime type 'application/x-java-jnlp-file'.
   - Point the JNLP file/mime type association created above to the
     Java Web Start application. This usually involves browsing to
     the Java Web Start binary executable (e.g. 'javaws' on Linux,
     'javaws.exe' on Windows).  This executable is typically located
     in the 'bin' subdirectory of the directory where your JRE is
     located.
   - Save your configuration changes.
   - Exit and restart the web browser.

Additional information on configuring your browser for Java Web Start is
available from Sun's web site at the following URL:

   http://java.sun.com/docs/books/tutorial/information/javawebstart.html

Web Launch Services Installation
--------------------------------

To install HBAnyware Web Launch Services, run the following script:

   /usr/sbin/hbanyware/wsinstall

This script will prompt you for several pieces of information that
pertain to the installed web server:

   - The IP address to which HTTP requests are made.  The installer 
     will automatically try to determine this IP address, and the
     address so determined will be presented to you for verification.
     If the address is  not acceptable, then you may enter the IP
     address of your choice.
   - The TCP port number that the web server is listening on.  The 
     default web server port is port 80. If your web server is using
     a port other than port 80, then you will be prompted to enter 
     the correct port number.
   - The web server's document root directory (i.e. the default 
     location the web server searches for web documents).  The
     default location is typically platform specific.  On Solaris
     platforms, this location is usually /var/apache/htdocs.

After you have entered the above information, the necessary Web Launch 
configuration files will be created, and Web Launch Services will be
automatically started.  To verify that the product is indeed functioning, 
go to some other client that has a web browser and enter a URL with the
following format:

   http://IP_ADDR:PORT_NUM/hbanyware.jnlp

where IP_ADDR is the IP address of host on which you installed the HBAnyware 
Web Launch service, and PORT_NUM is the TCP port number that that hosts'
web server is listening on.  If all is well, you will be presented with the
standard HBAnyware user interface.


Uninstalling HBAnyware Web Launch Services
------------------------------------------

To uninstall Web Launch Service, execute the following script:

    /usr/sbin/hbanyware/wsuninstall

This script will stop the Web Launch Service daemons (if they are running)
and remove all Web Launch related files from the host.

Starting and Stopping Web Launch Services
-----------------------------------------

Web Launch Services may be stopped at any time by executing the following
command:

    /usr/sbin/hbanyware/stop_weblaunch -all

Web Launch Services may be started (provided they have been previously
installed) by executing the following command:
 
    /usr/sbin/hbanyware/start_weblaunch


Known Problems
--------------

1. Multiple Java Version Confusion

The document caching mechanism that resides in Microsoft Internet Explorer
and Java Web Start sometimes behaves erratically if more than one version
of the Java Runtime is installed on the browser client.  If there are multiple
versions of the Java Runtime installed on your Internet Explorer client, then
it is possible that you will receive the following text in the browser's main
display window when you attempt to launch HBAnyware via the browser:

   Emulex Corporation HBAnyware Demo of HBAnyware WebStart web n.n.n.n .....

If you receive this, and you are certain that the HBAnyware Web Launch
Services package has indeed been installed and is running on the target
server, then there are two possible workarounds to this problem:

  -- Exit the browser, then restart it.   HBAnyware should launch successfully
     after this.
  -- Uninstall all non-essential versions of the Java Runtime.  HBAnyware
     Web Launch services require that only a single version of the Java
     Runtime be installed on the Windows browser client.  This single version
     should be JRE version 1.5, or greater.

2. Reinstall Required If IP Address or TCP Port of Web Server Changes

If the IP address or TCP port number of your Apache Web Server has changed,
then you must reinstall Web Launch Services.  First, uninstall the Web Launch
Services package by typing:

     /usr/sbin/hbanyware/wsuninstall

Then reinstall Web Launch Services by typing:

     /usr/sbin/hbanyware/wsinstall

During installation, when prompted, be sure to enter the new IP address and
TCP port number for the Apache Web Server.



